docs: Mention cairo-gobject as build requires

Using cairo from a system dependency and cairo-gobject
as subproject is problematic and left me stuck on a
hard-to-understand build error.

gsk: Fix some docs oversights

These apis have been renamed a few times, and the docs
haven't kept up.

gdk: Docs cosmetics

Add a few missing parameters in doc comments.

docs: Fix a typo

docs: Remove gtk_render_insertion_cursor

This function was removed in 2bcef7f03058dac7cbac.

gtk-demo: Plug a memory leak

The Characters demo was leaking its columns.

modelbutton: Fix keynav for check and radio

The expected behavior when activating check or radio
menuitems via keynav is that Space toggles the item
but keeps the menu open, while Return toggles the
item and closes the menu.

Merge branch 'fix-tooltip-trigger' into 'master'

Fix tooltip triggering

See merge request GNOME/gtk!2833

Fix tooltip triggering

Ever since 5b5d2665d373c35f, tooltips don't work properly,
since we get more motion events now, and those keep the
tooltips from appearing. This can be seen e.g. on the icon
in the password entry in widget-factory, or on the section
switcher buttons in the Emoji chooser.

Ignore synthetic motion events for the purposes of
determining whether the user moved the mouse.

Merge branch 'widget-no-a11y-crash' into 'master'

gtkwidget: fix crashes with GTK_A11Y=none

Closes #3333

See merge request GNOME/gtk!2834

gtkwidget: fix crashes with GTK_A11Y=none

at_context can be NULL in that case, so guard against it.

Fixes #3333

Merge branch 'button-fill-var-removal' into 'master'

Adwaita: Stop using $button_fill

Closes #3354

See merge request GNOME/gtk!2828

Merge branch 'parse-debug-env-vars-always' into 'master'

Always parse GTK/GDK/GSK_DEBUG env vars and make some entries available in non-debug mode

See merge request GNOME/gtk!2830

Revert "Update comment annotations of gtk_tree_model_iter_previous and gtk_tree_model_iter_next to state that the ITER parameter is modified."

This reverts commit 1340ff2bc279329dc16b8d823100fec46b2f11d8.

Same as with 53cd499621b5

Always parse GTK/GDK/GSK_DEBUG env vars and make some entries available in non-debug mode

Currently GTK can be built with G_ENABLE_DEBUG which enables various debug code and parsing
of those env vars, or without, which instead of parsing them prints a warning if they are set.
While building with G_ENABLE_DEBUG isn't strictly needed it's the only way to make GTK_DEBUG=interactive work,
which is a nice thing to have always.

This enables parsing of those env vars in any case and allows specific values being marked as also
available when not built with G_ENABLE_DEBUG (interactive for example). If not built with G_ENABLE_DEBUG
then all unavailable values will be marked as such in the help output and a note is added that
GTK needs to be built with G_ENABLE_DEBUG to use them, which should help discoverability.

Update Ukrainian translation

Merge branch 'wip/carlosg/for-master' into 'master'

gtk/main: Reset active state on grab broken only if implicit

See merge request GNOME/gtk!2832

gtk/main: Reset active state on grab broken only if implicit

An implicit grab means some button is down, reset the active state
only in that case when we get a grab broken event.

Avoids active state accounting warnings when we do get active grabs
broken (e.g. after selecting a menu option).

Adwaita: Stop using $button_fill

Since the $button_fill variables are no longer used outside of the
button() mixin (and it was for an ugly hack), there is no need to keep
that anymore.

Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/3354

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

Closes #3359 and #3353

See merge request GNOME/gtk!2827

Adwaita: Fix list separators

Commit bfe5b0d1b7a1374964 ran into some specificity
trouble.

Fixes: #3353

label: Avoid short-circuiting

Commit 0db504edde63eb77e made a mistake described here:
https://en.wikipedia.org/wiki/Short-circuit_evaluation#Possible_problems

Fixes: #3359

Merge branch 'alatiera/nightly-demos' into 'master'

ci: publish demo apps to the Nightly repository

See merge request GNOME/gtk!2825

Merge branch 'wip/jimmac/tooltips' into 'master'

Adwaita: tooltip styling

Closes #3352

See merge request GNOME/gtk!2826

ci: publish demo apps to the Nightly repository

Adwaita: tooltip styling

- balance padding
- increase border radius, yuck
- get rid of text shadow

Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/3352

Merge branch 'wip/jimmac/submenus' into 'master'

Wip/jimmac/submenus

See merge request GNOME/gtk!2824

Merge branch 'wip/jimmac/declare-buttonfill-once' into 'master'

Adwaita: double declated $button_fill

See merge request GNOME/gtk!2823

Adwaita: rounded submenus

- all corners have rounded corners

See https://gitlab.gnome.org/GNOME/gtk/-/issues/2745

Adwaita: double declared $button_fill

- this was already in place in _common, no need to have it in _colors

Adwaita: double declated $button_fill

- this was already in place in _common, no need to have it in _colors

Merge branch 'wip/exalm/window' into 'master'

Round window corners

See merge request GNOME/gtk!1952

Merge branch 'wip/carlosg/for-master' into 'master'

Improve handling of ::active with touch and multiple foci

Closes #3348

See merge request GNOME/gtk!2821

gtk/main: Stack ::active calls

We may have the situation of multiple touchpoints in the same
widget, or combinations with other devices. Stack those ::active
states are preserved on widgets on all but the last pointer/touch
going away.

gtk/main: Toggle active flag with touch events

This went missing at some point, add the missing toggling of active
state with GDK_TOUCH_BEGIN/END/CANCEL events.

Fixes: https://gitlab.gnome.org/GNOME/gtk/-/issues/3348

Merge branch 'ebassi/for-master' into 'master'

Ebassi/for master

See merge request GNOME/gtk!2819

a11y: Use GROUP role for ShortcutsShortcut

And hide the image from the accessible tree.

a11y: Implement atspi.Text.ScrollSubstringTo for GtkTextView

We reuse the existing implementation in GTK3.

a11y: Document GtkRevealer's accessible state

Use the GROUP role, and make sure to note that the child is always
revealed. Unlike GtkExpander, GtkRevealer can only be programmatically
toggled, so we cannot turn it into a "button" object.

a11y: Add more accessible data to GtkTreeExpander

Document the role of the GtkTreeExpander, and the behaviour of the
expander button.

Additionally, improve the label of the expander button, by adding a
fixed "Expand" label, and setting the "labelled-by" relation to the
child of the GtkTreeExpander.

Establish a control relation between demo search and list

The search entry changes the content of the list view, so we should
mention that relation to assistive technologies.

a11y: Add accessible actions to GtkSearchEntry

Just like GtkPasswordEntry, GtkSearchEntry should have its set of
accessible actions.

a11y: Mark SearchEntry icons as presentational

While the "clear the search entry" icon behaves like a button, we don't
have any actual action that can trigger it, so let's ignore it.

a11y: Set the role on GtkSearchBar

The search bar widget has a "SEARCH" landmark role, which is described
as:

    A landmark region that contains a collection of items and
    objects that, as a whole, combine to create a search facility.

a11y: Icons in buttons are presentational

Buttons are described by text, and the icon child can be safely ignored.

a11y: Add more accessibility labels to GtkNotebook

Label the various components:

 - the tab list
 - the tab widget
 - the arrow widgets

a11y: Use the stack page title as its accessible label

a11y: GtkStack is a group of stack pages

Handle empty stack pages when creating an ATContext

If we don't have a widget inside GtkStackPage, we should use the default
GdkDisplay.

Unrealize the ATContext in StackPage on dispose

Otherwise we're going to try to unrealize it during the GtkStack
destruction, which will emit warnings.

a11y: Icons in WindowControls are presentational only

They don't contribute anything to the accessible description.

a11y: Ignore more structural roles when computing labels

These roles should not have a fallback name when explicitly unlabelled.

a11y: Add role exception for GtkScrolledWindow

ARIA does not have a "scroll pane" role, but AT-SPI does.

demo: Add more accessibility labels to the UI

Merge branch 'clear-search-entry' into 'master'

searchbar: Fix clearing search entry on hide

See merge request GNOME/gtk!2820

searchbar: Fix clearing search entry on hide

Commit fa3d1940bf2b36 added separate grab handling for GtkSearchEntry, but
didn't consider whether the bar was revealed or concealed. The expected
behavior for the latter is that the entry is cleared rather than focused,
fix the condition accordingly.

theme: Round all window corners

theme: Restructure window style

Merge branch 'ebassi/for-master' into 'master'

ATContext lifetime fixes

Closes #3341

See merge request GNOME/gtk!2811

Merge branch 'wip/jimmac/sassc-global-vars' into 'master'

Adwaita: avoid !global

See merge request GNOME/gtk!2816

Adwaita: avoid !global

- Work around having !global variables as sassc will
  no longer support it

docs: Add "Accessibility" section to various widgets

There are a few widgets that gained an accessible role, which means
adding an "Accessibility" section in their description.

Merge branch 'suggestion-entry-demo2' into 'master'

gtk-demo: Add suggestion entry demos

See merge request GNOME/gtk!2812

gtk-demo: Add suggestion entry demos

Add a possible replacement for GtkEntryCompletion
as a demo.

Move the Dropdowns demo to Lists/Selections, and make
it show both GtkDropDown and the suggestion entry, with
some variations.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2810

a11y: Simplify GtkModelButton

Instead of recreating GtkATContexts in order to change their role, we
can simply unrealize and realize them back.

a11y: Add missing fallback for accessible-role getter

If the per-instance accessible role is unset, use the class role.

a11y: Rework ownership and lifetime of GtkATContext

Now that GtkATContext is explicitly realized and unrealized, we should
always create an instance at widget initialization time, and drop it
during the widget finalization. This should make it easier to set up the
initial accessible state of a widget during the instance initialization,
as well as reduce the chances of accidental creation of GtkATContext
instances during the destruction sequence.

a11y: Defer to the GtkAccessible's implementation

Since GtkATContexts are now lazily realized, we need to go through the
GtkAccessible's implementation to access the :accessible-role property,
in case there are fallbacks.

a11y: Create AtSpiRoot on realization

There's no need to do a lot of work on construction, if we're delaying
all remote work after the GtkATContext is realized.

The GtkAtSpiContext should also keep a reference on the root, and drop
it at unrealize time.

a11y: Use GROUP role for GtkNotebook

A notebook is a grouping of a tab list, tabs, and tab pages.

a11y: Protect should_present() from empty contexts

If the GtkAccessible implementation returns a NULL context, we should
not be calling methods on it.

a11y: Do not leak the ATContext in GtkStackPage

GtkStackPage is not a widget, so it must release the reference on the
ATContext it owns.

a11y: Mark more containers as structural elements

Widgets that just provide grouping and layout to other widgets should
not be relevant to the accessible tree.

a11y: Use the window title as its label

a11y: Skip unlabelled structural roles

If a structural role is left unlabelled, just leave it unnamed.

a11y: Translate ARIA windows to AT-SPI frames

For backward compatibility with GTK3.

a11y: Add more ARIA/AT-SPI role translations

a11y: Realize parent ATContext for the stack page

Just like for popovers, the stack page is not directly connected on the
widget's DOM, so we need to realize the parent ATContext ourselves.

a11y: Implement missing atspi.Component getters

Some of them are entirely innocuous, and we can easily provide values
that match what GTK3 provides.

a11y: Unrealize ATContext on dispose()

By unrealizing the context we avoid additional work during the dispose
phase, in case widget code updates the accessible state. We use
GtkAccessible's API, to ensure we unrealize the right ATContext, instead
of the one we store inside GtkWidgetPrivate.

We drop the ATContext instance inside GtkWidget during finalization, to
mop up eventual vivifications there.

Adwaita: Don't do n-th child things for list rows

Making the list row child css depend on the position
is very expensive, and does not acutally work correctly
(since we don't have widgets for all children, so the
position of the child widget does not reflect the actual
model item position).

To make this more palatable, use the bottom border
instead of the top border, since most lists have a natural
border at the top (with headers), and may end up with
empty space at the bottom.

label: Avoid a needless strdup

Don't duplicate the string before we know if it
has actually changed.

label: Optimize GtkLabel setters

The overarching goal here is to not queue a resize
unless something has actually changed. In columnview
scenarios, we often deal with hundreds of labels.

Labels are cattle, not pets.

gtk-demo: Split off SvgPaintable

Put the SvgPaintable implementation into its
own source files, for ease of copying.

Don't hide widgets in dispose()

This is leftover code from when widgets were hidden
by default, and was setting them back to their initial
state.

This is getting in the way now, as hiding the widget
updates the HIDDEN accessible state, which ends up
re-creating the at context that we've already disposed
of, leading to memory leaks.

Merge branch 'matthiasc/builder-requires' into 'master'

Matthiasc/builder requires

See merge request GNOME/gtk!2806

Merge branch 'fix-demos-wo-pangoft2' into 'master'

gtk-demo: Fix building scrolling demo without PangoFT2

See merge request GNOME/gtk!2807

gtk-demo: Fix building scrolling demo without PangoFT2

For builds that do not have PangoFT2, the demo fails to link because we weren't
building listview_ucd.c.  Fix the build by building listview_ucd.c with
script-names.c and unicode-names.c for all builds, as we now require a Pango
version that already always depends on HarfBuzz and those sources do not use
anything from PangoFT2.

testsuite: Update buildertool tests

gtk-builder-tool simplify --3to4 now produces a
<requires lib="gtk" version="4.0"/>.
Adapt for that, and also add some tests that check that we
actually verify the requires, and accept 3.99 and 4.0, but
not 5.x.

buildertool: Supplant a requires

When we convert a ui file to GTK 4 syntax, we *know*
that it requires GTK 4, so put that in the output.

builder: Be a bit more strict about requires

Check that the major version matches (without this, the
requires check is really toothless), but allow 3.99 to
match 4.0.

testsuite: Remove <requires> from ui files

We don't need these here, the testsuite is shipped
with GTK.

examples: Remove requires from ui files

No need to check requires for things that are shipped
with GTK.

gtk4-demo: Remove <requires> from ui files

No need to check requires for things that are shipped
with GTK.

gtk: Remove <requires> from ui files

We don't need to check requirements for things
that are shipped *with* gtk.

Merge branch 'ebassi/for-master' into 'master'

Ebassi/for master

Closes #3343 and #3342

See merge request GNOME/gtk!2804

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2805

docs: Add example of relations with lists of references

a11y: Clone GtkATContext in GtkModelButton

The hypothetical widget that needs to clone ATContext instances
because it needs to control the accessible role post-construction is
really GtkModelButton.

Fixes: #3342